The following section describes how to upgrade Smart Integration Connector.
IMPORTANT: For best performance and reliability, upgrade Smart Integration Connector to match your OneStream version. While Smart Integration Connector Local Gateway Server supports the most recent previous version of OneStream, full functionality is not guaranteed.
Upgrade from:
-
Private Preview versions 7.2, 7.3,
-
Limited Availability version 7.4, or
-
General Availability versions 8.x to 9.2
As part of the upgrade, you can expect the following:
-
A copy of the original configuration file from the prior version will be saved.
-
Existing connections should continue to function as they did prior to the install.
-
If the Smart Integration Connector Windows Service is running, then the service will automatically be started after install.
If you perform an upgrade and have issues or do not achieve these results, contact OneStream Support.
-
Install the latest version of OneStream. The latest version can be requested and scheduled through the OneStream Software Cloud Customer Service Catalog. Make a note in the details section of the ticket that you want to install and configure the Smart Integration Connector.
-
Download the Smart Integration Connector install (OneStream_Connector_#.#.#.zip) file from the Platform section of the Solution Exchange.
-
Extract the OneStreamSmartIntegrationConnectorGateway-#.#.#.#####.msi from the downloaded zip file.
-
Back up a copy of your configuration folder and sub folders before upgrading. Default is: C:\Program Files\OneStream Software\OneStream Gateway\.
-
Follow the steps in Installation and Setup to complete your upgrade.
NOTE: If the upgrade process is interrupted or canceled, the Smart Integration Connector must be reinstalled.
If the Smart Integration Connector Windows Service was configured to start using a custom service account prior to upgrading, confirm that the service is set to start using the correct service account after the upgrade is completed.
NOTE: For OneStream Local Gateway Server version 8.1 and above, the default location for Reference Assembly Folder is C:\Program Files\OneStream Software\OneStream Gateway\Referenced Assemblies.
